home *** CD-ROM | disk | FTP | other *** search
/ Wayzata's Best of Shareware PC/Windows 1 / Wayzata's Best of Shareware for PC-Windows - Release 1 - Wayzata Technology (1993).iso / mac / DOS / TELECOMM / PDL316 / PDL.DOC < prev    next >
Text File  |  1992-09-18  |  30KB  |  717 lines

  1.                           Pro Down Load
  2.                   Copyright 1990-1992 by FlexSoft
  3.  
  4.                             INTRODUCTION
  5.                          ------------------
  6.  
  7. Timely access to current market information is a crucial requirement for
  8. the successful technical investor.  This valuable information is
  9. available from many sources and is accompanied by an equal number of
  10. access fees and connect charges.  One of the most reliable and
  11. economical sources of this data, although often overlooked, is the
  12. Prodigy(R) service, a joint venture of IBM(R) and Sears(R).
  13.  
  14. Initially, Prodigy made market information available to subscribers as
  15. graphics screen data only and provided no facility to the user for
  16. recording or capturing the information.  In time though, this facility
  17. was improved to include a print function.  This allowed recording of
  18. data but was not a practical method for collecting large amounts of data
  19. and was only moderately useful in maintaining historical stock market
  20. data files.  Since then Prodigy has added the ability to save quote data
  21. to a file but this method is still very time consuming for collecting
  22. large amounts of data.
  23.  
  24. As the Prodigy service began to stabilize the data formats, some users
  25. began to adopt methods of electronic data collection by employing print
  26. capture programs such as LPTx701, available on a variety of bulletin
  27. boards and services.  Further enhancements added automated keyboard
  28. macros to assist in requesting the quote information.  These programs
  29. began to bring the value of the Prodigy service as a daily stock quote
  30. update service into focus.
  31.  
  32. The obvious next step was to further automate and refine the process to
  33. make data collection as painless as possible.  PDL or "piddle" as it is
  34. referred to by the authors, is that next step.
  35.  
  36. Although the general purpose programs for keyboard simulation and
  37. print file capture are still viable alternatives, PDL was designed
  38. specifically for the purpose of downloading and recording stock, bond,
  39. mutual fund and market indicator information from the Prodigy service.
  40. The techniques employed in the PDL software take full advantage of the
  41. DOS platform and focus on collecting the market data that you need.  The
  42. limitations placed on the number of quotes that can be retrieved in one
  43. session (up to 1000 for Quote Check) far exceeds the practical limits of
  44. other methods.
  45.  
  46. Another advantage of PDL is the ability to use different quote request
  47. files for each session without having to make changes to your QUOTE
  48. TRACK lists.  This provides access to a limitless number of quotes by
  49. combining the stock symbols of your choice in one of an infinite number
  50. of quote lists.  Users of TAS, a technical analysis program which is
  51. growing in popularity, will find it easy to generate "TAS scripts" to
  52. automatically generate "ticker" lists.  These lists can be generated to
  53. be used as direct input to the PDL program.
  54.  
  55. Perhaps the most important point of all is that the authors themselves
  56. uses PDL daily to maintain databases in excess of 500 symbols.  What
  57. this means to the user is that changes in the Prodigy service that
  58. require programming changes will get immediate attention and these
  59. changes will be made available to licensed customers of PDL as quickly
  60. as the code can be developed and tested.  Also, as the authors add
  61. enhancements for their own use, these enhancements too will become part
  62. of the product.
  63.  
  64. WHAT DOES IT DO?
  65. ----------------
  66.  
  67. The basic function of PDL is to download stock, bond, mutual fund and
  68. market index data.  It gets this data from the Prodigy service's QUOTE
  69. CHECK and QUOTE TRACK functions using a user generated quote request
  70. file (often referred to as the PDL.IN file) and places the ASCII
  71. formatted text in a user defined output file (referred to as the PDL.OUT
  72. file).  Currently, PDL will accept requests for specific "ticker"
  73. symbols from the STOCK, BOND and FUND screens of QUOTE CHECK.  The setup
  74. procedures and a sample file are included later in this document.
  75.  
  76. A second feature of PDL is the ability to collect the information from
  77. the MARKET CLOSE function of Prodigy.  The screens that are captured
  78. provide direct access to a large number of indicators and indirect
  79. access to some additional derrived indicators.  An example of a directly
  80. accessed indicator is the DJ-30, the closing price of the Dow Jones
  81. Industrial Average.  A derrived indicator might be the cumulative
  82. difference of the new highs minus the new lows.  The PDL user can access
  83. the direct indicators using editors, spreadsheets or various other
  84. software products.  The derrived indicators require the use of PML since
  85. they are calculated from the direct information.  One of the
  86. shortcomings of the Prodigy indicators is that only the close values for
  87. the indicators are recorded.  If you absolutely need high & low values
  88. for the DJ-30, NYSE etc., you will have to collect the individual stock
  89. data and calculate it yourself.
  90.  
  91.  
  92. SUPPORT
  93. ------------
  94.  
  95. PDL was written as a companion program to Personal Ticker Tape (PTT)
  96. which is designed to load and update Metastock Professional
  97. data files from a variety of sources using a variety of input formats.
  98. Although PML is a companion program, it is not required to get full use
  99. of PDL but rather uses the PDL output as an update source.  PDL ASCII
  100. formatted files are recorded in a format that is usable by most
  101. spreadsheet and database programs that employ format descriptors.  Of
  102. course the data can also be accessed and edited using a standard ASCII
  103. text editor such as EDLIN.
  104.  
  105. Each of these programs (PDL & PTT) requires registration to receive
  106. full technical support although users are encouraged to redistribute
  107. copies of the entire package for demonstration purposes.  Both
  108. programs are distributed and run in a trial, or limited demonstration
  109. mode.   PDL provides a limited use (20 quotes per session) demo.
  110. During the trial period, the authors will attempt to answer questions
  111. about software install and configuration.
  112.  
  113. As a registered user, you will be have access to enhancements to the
  114. products as they become available and also be entitled to any available
  115. technical fixes to the version for which you are licensed.  This
  116. includes changes required to accommodate new formats in the Prodigy
  117. service data, and assumes that the required data is still available.
  118.  
  119. You can register any FlexSoft Product(s) online by calling the
  120. FlexSoft BBS at 510-829-2293 and answering Questionaire #3
  121. (VISA/MasterCard Only) In addition, you can send your name, address,
  122. VISA/Mastercard # and expiration date to JBMD65A to register PDL
  123. immediately.
  124.  
  125. If you wish to register by check, print the the REGISTER.DOC file, fill it
  126. out, and send it to the address given on the form.
  127.  
  128.  
  129.    Technical problems can be reported:
  130.        on Prodigy ID   - CBGB69A        Rick Woodcock
  131.  
  132.                           HOW TO USE PDL
  133.                       -----------------------
  134.  
  135.  
  136. PREPARING YOUR QUOTE LIST
  137. ----------------------------
  138.  
  139. PDL requires the use of a standard text editor and a few minutes of your
  140. time to set up the list of symbols that you wish to download.  This list
  141. is stored in a file referred to as the PDL.IN file.  The actual name of
  142. the file can be any legal DOS filename, but the default name is PDL.IN.
  143. The list contains one line for each Stock, Fund or Bond quote that you
  144. want to download.  Each line contains an indicator specifying the "type"
  145. of quote (Stock, Bond, Fund or indeX) and the symbol.  The "type"
  146. indicator is defined as:
  147.  
  148.            "S"     - stock symbol
  149.            "F"     - fund symbol
  150.            "B"     - bond symbol
  151.            "X"     - market close page or special indicator
  152.  
  153. For example, to get a quote for Apple Computer (AAPL), a stock, you
  154. would type in the line:
  155.  
  156.            S AAPL
  157.  
  158. And for JANUS FUND (JANSX), a fund, you would type in:
  159.  
  160.            F JANSX
  161.  
  162. Similarly, for a bond, you would precede the symbol with a "B".
  163.  
  164. To get the Market Close page containing the AMEX closing information you
  165. would type in:
  166.  
  167.            X AMEX
  168.  
  169.  
  170. The available Market Close page names are:
  171.   X AMEX        American Exchange Summary
  172.   X NYSE        New Your Exchange Summary
  173.   X US          US Stocks Summary
  174.   X KEY         Key Rates and Bonds
  175.   X NASDA       NASDAQ Closing Summary
  176.   X CLOSI       Closing Futures Prices
  177.   X FOREI       Foreign Exchange Currencies
  178.   X MFUND       Mutual Fund close page
  179.   X AACTV       AMEX most actives
  180.   X NACTV       NYSE most actives
  181.   X QACTV       NASDAQ most actives
  182.   X UPDAT       Market Update summary (US Stocks)
  183.  
  184. Normally you will want to include all of these in your quote list.
  185.  
  186. Switching between "B", "S" and "F" types cause mode switches within
  187. Prodigy that take time.  You can obtain the best performance by
  188. grouping all symbols of each type together so that all stocks are
  189. requested sequentially, followed by all fund requests, followed by
  190. all bond requests.  PDL will not get confused if you mix up the types
  191. but the time that it takes to download can be greatly extended.
  192.  
  193.  
  194.  
  195. X QRQ30 Symbol
  196. --------------
  197.  
  198. QRQ30 is a special symbol that allows a fast download of 30 stock
  199. symbols using the Quote Track lists.  To use this symbol you must first
  200. set up the quote requests in Quote Track list #1 and #2.  Next you
  201. should add the symbol X QRQ30 to your PDL.IN file.  Although placement
  202. is not critical the X QRQ30 symbol should be the first X symbol
  203. specified for best program efficiency. One excellent use of this feature
  204. is to place the Dow 30 stocks in the list since these stocks do not
  205. change frequently.
  206.  
  207. * BOTH QUOTE TRACK LISTS SHOULD BE USED IF POSSIBLE.  THE DOWN LOAD WILL
  208.   STILL WORK CORRECTLY IF YOU HAVE PARTIAL LISTS BUT YOU WILL HEAR A
  209.   BEEP IF EITHER LIST IS EMPTY.
  210.  
  211. PDL will collect quotes in the following order: all Quote Check requests
  212. for Stocks, Bonds and Funds; Quote Track requests if QRQ30, personal
  213. lists or PDL AUTOTRAK is specified; Market Close pages if the X symbols
  214. are specified.
  215.  
  216. * X symbols are only available on the registered versions of PDL.
  217.  
  218.  
  219. PDL AUTOTRAK
  220. ------------
  221.  
  222. PDL AUTOTRAK is a new feature implemented in PDL316 that makes use of
  223. the new personal quote lists available in Quote Track.  To activate PDL
  224. AUTOTRAK place the following line "L ###" in front of all of your
  225. individual symbols in the PDL.IN file. For example:
  226.         L ###
  227.         S AAPL
  228.         S ASA
  229.         S BEV
  230.         F MRPAX
  231.         X AMEX
  232.         ...
  233. This tells PDL to collect all of the S, F, and B symbols that follow
  234. into personal quote lists and use the Quote Track function to download.
  235. These files will contain up to 50 quotes each and will be stored in the
  236. Prodigy directory. You do not have to worry about maintaining the
  237. personal lists, PDL will rebuild them from the PDL.IN file each time it
  238. starts up. They will be named "PDL#" followed by a sequence number.
  239.  
  240. PDLMIS will detect symbols that are not found since (even though it uses
  241. Quote Track lists) it knows about all of the sumbols from the PDL.IN
  242. file.
  243.  
  244.  
  245. PERSONAL QUOTE LISTS
  246. --------------------
  247.  
  248. Quote Track provides you with the ability to build and name lists of
  249. securities on your own hard disk.  While there is no real reason to do
  250. this (PDL AUTOTRAK replaces the function), you may want to have some
  251. "special" lists saved under unique names.  PDL supports these lists with
  252. the type 'L' function.  The following format is used to include the
  253. lists:     L <filename>
  254.  
  255. For example, if you had a personal list that you built and saved (using
  256. the Quote Track facility) as "MYSTOCKS.IN" you would enter:
  257.         L MYSTOCKS.IN
  258.  
  259. You can enter as many of these personal lists as you like in each PDL
  260. download and can combine them with other individual securities.  For
  261. example:
  262.         S ASA
  263.         S BLY
  264.         S IBM
  265.         L MYSTOCKS.IN
  266.         S GM
  267.  
  268. You can also combine personal lists with PDL AUTOTRAK as long as you
  269. place all personal lists at the beginning of the file. For Example:
  270.         L MYSTOCKS.IN
  271.         L ###
  272.         S ASA
  273.         S BLY
  274.         S IBM
  275.         S GM
  276.  
  277. Any lists that appear after the "L ###" symbol will be ignored.
  278.  
  279. PDLMIS cannot detect missing tickers inside of personal lists.  If any
  280. of these symbol is not found, PDLMIS will not return an error.
  281.  
  282.  
  283. SPECIAL SYMBOLS
  284. ---------------
  285.  
  286. Prodigy recognizes a number of special symbols that are referred to as
  287. the &*** symbols. These represent specific market indicators. A complete
  288. list is available on Prodigy.  These symbols are supported as type 'S'
  289. in PDL and are entered in the PDL.IN in the same manner as a stock
  290. symbol.  For example:
  291.         S &DJIA
  292.         S &DJT
  293.         S &DJU
  294.         S &DJC
  295. They can be treated in much the same manner as other symbols in that
  296. they can be included in Quote Track lists or entered individuall in
  297. Quote Check.
  298.  
  299.  
  300. RUNNING PDL
  301. -----------------
  302.  
  303. PDL has a default quote list file named "PDL.IN".  If you choose to name
  304. it something else, you will need to tell PDL by running the PDLCONF
  305. program.  This will change the input file name in the PDL.CNF file and
  306. also in the PDLRUN.BAT file.  In addition, it stores the Prodigy quotes
  307. in a file called "PDL.OUT" unless you give the output file another name.
  308.  
  309. PDL is started by entering the command PDLRUN at the DOS prompt.  If you
  310. get a DOS message "Out of Environment Space", you will have to increase
  311. the environment size by placing a SHELL command in your CONFIG.SYS file.
  312. A typical SHELL command is:
  313.    SHELL = C:\COMMAND.COM /P /E:512
  314. If you are running PDL & Prodigy in a DOS window under Microsoft Windows
  315. and continue to have problems with environment space, place the
  316. following in your AUTOEXEC.BAT file:
  317.    SET TRY = 0
  318.    SET PDLRUN = OFF
  319. This will reserve space for the PDL environment variables.
  320.  
  321. PDL is ALWAYS run from a batch file.  A typical batch file, such as
  322. PDLRUN.BAT which is built by the PDLCONF program follows:
  323.  
  324. echo off
  325. echo *********************************************************************
  326. echo *                       PDLRUN.BAT                                  *
  327. echo *********************************************************************
  328. set TRY=0
  329. set PDLRUN=ON
  330. cd C:\PDL314
  331. pdl PDL.IN PDL.OUT
  332. :newtag
  333. pdlmis PDL.IN PDL.OUT PDL.NEW
  334. if ERRORLEVEL 1 GOTO :more
  335. GOTO :endit
  336. :more
  337. GOTO :T%TRY%
  338. :T0
  339. goto :nogood
  340. :T1
  341. set TRY=0
  342. goto :tag
  343. :T2
  344. set TRY=1
  345. goto :tag
  346. :T3
  347. set TRY=2
  348. goto :tag
  349. :T4
  350. set TRY=3
  351. goto :tag
  352. :T5
  353. set TRY=4
  354. goto :tag
  355. :T6
  356. set TRY=5
  357. goto :tag
  358. :T7
  359. set TRY=6
  360. goto :tag
  361. :T8
  362. set TRY=7
  363. goto :tag
  364. :T9
  365. set TRY=8
  366. :tag
  367. pdl -a PDL.NEW PDL.OUT
  368. GOTO :newtag
  369. :nogood
  370. echo Retry count exhausted - PDL terminating
  371. :endit
  372. new2old
  373. copy HISTORY.FIL+PDL.OUT HISTORY.FIL
  374. set PDLRUN=OFF
  375.  
  376. Most of this batch file is concerned with checking for missing quotes
  377. and restarting PDL if a failure occurrs.  There should be no need to
  378. edit this file other than by using the PDLCONF program.
  379.  
  380.  
  381.  
  382.                              PDL FILES
  383.                              ---------
  384.  
  385.  
  386. PDL INPUT AND OUTPUT FILES
  387. --------------------------
  388.  
  389. Suppose your quote list is in a file called DJ30.STK and you want to put
  390. the Prodigy quotes in a file called DJ30.LST.  Then you would start
  391. PDLCONF, go to the Change Startup Parameters screen to make the changes
  392. and then select the Update Parameter Files option to build the new
  393. PDLRUN.BAT and PDL.CNF files.
  394.  
  395. The default quote list file name is PDL.IN and the default output
  396. filename is PDL.OUT.  If you have no need to change these names, it
  397. might make things simpler to just use the defaults.
  398.  
  399.  
  400. THE PDL.CNF FILE
  401. -------------------
  402.  
  403. If you use PDLCONF to build the startup configuration and batch files
  404. you can ignore this section since this is taken care of automatically.
  405.  
  406. The PDL.CNF file contains many of the parameters that PDL needs to start
  407. and run correctly.  The following is the format of the file:
  408.  
  409. USERID = ABCD99                your Prodigy UserID
  410. PASSWD = BANANA                your Prodigy Password
  411. REG_CODE = UNREGISTERED        your PDL registration code
  412. COMM_PORT = 3F8                your modem port address
  413. LOGON = PDL                    the type of logon requested
  414. NICKNAME = JOHN                your Prodigy Autologon Nickname
  415. P_DELAY = 400                  delay after printing to a file
  416. D_DELAY = 400                  context switching delay
  417. RETRIES = 0                    number of attempts to restart Prodigy
  418. PRODIGY_PATH = C:\PRODIGY      the Prodigy drive and directory
  419. PDL_PATH = C:\PDL              the PDL drive and directory
  420. INFILE = PDL.IN                the input file name
  421. OUTFILE = PDL.OUT              the output file name
  422. NEWFILE = PDL.NEW              file to hold missing quote list
  423. HISTORY_FILE = HISTORY.FIL     file to hold archived pdl.out files
  424. NEXT PROGRAM CALL = PMLRUN.BAT name of program or batch file to run
  425.                                 after PDL completes
  426.  
  427. The format should be followed as shown above using all upper case
  428. letters and spacing on either side of the "=".  The file is built
  429. automatically by the PDLCONF program.
  430.  
  431.  
  432. KEYBOARD COMMANDS
  433. ------------------------
  434.  
  435. PDL has four keyboard commands which are available for limited control
  436. and alteration of PDL functions.
  437.  
  438.    ALT-S   - Suspend keystroke input
  439.    ALT-R   - Resume 'suspended' keystroke input
  440.    ALT-B   - Begin keystroke input from the top (for MANUAL logon)
  441.    ALT-X   - Exit. Causes PDL to release all interrupt vectors. This
  442.              command does not terminate Prodigy.
  443.  
  444. Under normal conditions it will not be necessary to use these commands
  445. and they can be a little trickey to use.  As you become more familiar
  446. with the PDL and Prodigy sequences you may want to try them out.
  447.  
  448.  
  449. PDL INSTALL PROCEDURE
  450. -------------------------
  451.  
  452. PDL comes in a ZIP file named based on the version of the program.
  453. Suppose you have PDL316.ZIP (which is version 3.1.6) of the software.
  454. This installation assumes you are placing PDL in your \PDL316 directory
  455. on drive 'C':
  456.  
  457.    1) Create the PDL directory using the DOS MD command and make that
  458.       the current directory.
  459.                              c:
  460.                              md c:\pdl316
  461.                              cd c:\pdl316
  462.  
  463.    2) Use PKUNZIP to extract the contents of PDL316.ZIP into your
  464.       \PDL316 directory.
  465.  
  466.       You should have the following files:
  467.  
  468.      PDL.EXE      -  Main program which passes keystrokes to Prodigy and
  469.                      places output in a file.
  470.      PDLKEY.COM   -  Program to translate your quote list to keystrokes.
  471.      PDLMIS.COM   -  Program to check for missing quotes.
  472.      PDLSCHED.COM -  The Vacation Scheduler program
  473.      NEW2OLD.COM  -  Converts PDL.OUT files from new to old format
  474.      PDLSCHED.CTL -  Control file for Vacation Scheduler
  475.      PDLCONF.EXE  -  The PDL configuration program.
  476.      PDLCONF.HLP  -  The help file for PDLCONF.
  477.      PDL.IN       -  A sample input file.
  478.      PDL.DOC      -  This document
  479.      REGISTER.DOC -  Registration form for PDL
  480.      PDLRUN.BXT   -  A template file used by PDLCONF to create
  481.                      PDLRUN.BAT
  482.      READ.ME      -  Quick start & last minute changes
  483.  
  484.    3) Create a file called PDL.IN containing your Stock, Fund,
  485.       Bond and indeX symbols.
  486.  
  487.    4) Start the configuration program by entering PDLCONF at the DOS
  488.       prompt.  Follow the instructions in PDLCONF.  Don't forget to save
  489.       each screen by selecting the F10 key and to save the PDL.CNF and
  490.       PDLRUN.BAT files by selecting Update Parameter Files.
  491.  
  492.    5) Type PDLRUN to start PDL and Prodigy.
  493.  
  494. *NOTE:  This version contains a data conversion program that converts
  495. the new Quote Check data format back to the old format. This was
  496. included to make PDL compatible with data extraction programs such as
  497. PML or PTT.  If you do not want the data converted back to the old
  498. format, remove the line "new2old" from the PDLRUN.BAT file.  If you
  499. choose to remove this line, the PDL.OUT file will be written out in the
  500. new Quote Check format and will NOT be compatible with PML or PTT.
  501.  
  502.  
  503.  
  504.  
  505. VACATION MODE
  506. -------------
  507.  
  508. Vacation Mode of operation provides a method of automating the startup
  509. of PDL on specific days or dates at a specific time.  There are two ways
  510. that this may be accomplished.  The first assumes that the computer will
  511. remain turned on for the duration of the unattended period.  The second
  512. assumes that power on/off control will be used to start the computer and
  513. that the autoexec.bat file will start PDLSCHED, the scheduler.   The
  514. scheduler is started by executing the PDLSCHED command from the PDL
  515. directory.
  516.  
  517. Method 1 - Power On
  518. A sample PDLSCHED.CTL file could contain the following:
  519.         INCLUDE:ALL
  520.         EXCLUDE:SAT
  521.         EXCLUDE:SUN
  522.         START:18:00
  523.         WAIT:
  524. This tells the scheduler to run PDL on every day except saturday and
  525. sunday, to start the run at 6PM and to re-enable the scheduler for the
  526. next day and WAIT for the correct start time.
  527.  
  528. Method 2 - Power control
  529. This method assumes that you have a way to automatically turn on the
  530. power at the time you wish the scheduler to start.  You will also
  531. need to add statements to your AUTOEXEC.BAT file to change the
  532. directory to the PDL directory and execute the PDLSCHED command. The
  533. PDLSCHED.CTL file could contain the following:
  534.         INCLUDE:ALL
  535.         EXCLUDE:SAT
  536.         EXCLUDE:SUN
  537.         EXCLUDE:12/25/91
  538.         START:18:00
  539. This tells the scheduler to run PDL on every day except saturday and
  540. sunday, to start the run at 6PM and to return to DOS after the run
  541. completes.  It also contains an example of how to exclude a specific
  542. date, in this case December 25, 1991.
  543.  
  544. The PDLSCHED program provides the option of changing the name of the
  545. PDLSCHED.CTL file on the command line.  For example:
  546.         PDLSCHED NEW.CTL
  547. causes the scheduler to use a control file named NEW.CTL.
  548.  
  549. One easy way to set up your system for method 2 is to build a bootable
  550. floppy disk that contains a copy of your CONFIG.SYS and AUTOEXEC.BAT
  551. from your hard disk root directory.  Add the statements needed to change
  552. to the proper directory to run PDL. For example, in AUTOEXEC.BAT:
  553.  BREAK ON
  554.  PATH C:\;C:\DOS;.....  REM Your normal PATH statement
  555.  .                      REM Other AUTOEXEC.BAT statements
  556.  .
  557.  C:                     REM Change to the C: drive
  558.  CD \PDL316             REM Change to the PDL directory
  559.  PDLSCHED               REM Call the scheduler
  560.  
  561. Starting with PDL315 the scheduler uses a method of scheduling that is
  562. more friendly to multitasking programs such as Microsoft Windows,
  563. DesqView and OS/2 2.0.  This new process reduces the amount of overhead
  564. taken by PDLSCHED while waiting for a specific time interval or date.
  565.  
  566.  
  567. Next Program Call
  568. -----------------
  569.  
  570. This feature is specified using the PDLCONF program to alter the
  571. configuration of PDL.  The most common use is to run a batch file to
  572. convert the PDL.OUT file to some other format.  For example, to call the
  573. PML program each time PDL is run you could:
  574.  
  575. 1. Build a batch file in your root directory named PMLRUN.BAT
  576.    containing the following:
  577.         CD C:\PML
  578.         PML -r
  579.         CD C:\PDL316
  580. 2. Put the following in NEXT PROGRAM CALL using the PDLCONF program:
  581.         C:\PMLRUN.BAT
  582.  
  583.  
  584. The PDLSCHED.CTL file
  585. ---------------------
  586.  
  587. The format of the scheduler control file is as follows:
  588.         CONTROL:VALUE
  589. where control is the keyword INCLUDE, EXCLUDE, START or WAIT separated
  590. by a colon from the value.  Values for INCLUDE and EXCLUDE are ALL, SAT,
  591. SUN, MON, TUE, WED, THU, FRI or a date in the format mm/dd/yy.  Values
  592. for START include any valid time in the format HH:MM:SS expressed in 24
  593. hour format (e.g. 18:00:00 is 6PM).  The WAIT keyword has no values
  594. associated with it but requires the colon separator to delineate the
  595. keyword.  WAIT: tells the scheduler to re-enable the program after the
  596. download completes and "wait" for the next timing interval (usually a
  597. date change at midnight). When the midnight crossing occurs, the
  598. scheduler will check to see if PDL should be run on that day.  If so, it
  599. will enable itself for the time specified in START:.  If the new date or
  600. day is one of the ones specified in EXCLUDE:, the scheduler will now
  601. wait for the next midnight crossing to occur.
  602.  
  603.  
  604. TELEPHONE LINE PROBLEMS
  605. ------------------------
  606.  
  607. If you used PDLCONF to build the parameter files, most of the restart
  608. will be taken care of automatically.  If you selected the MANUAL logon
  609. option or built your own startup batch file the following information
  610. may be helpful.
  611.  
  612. Occasionally problems will arise that require PDL to do something other
  613. than what it had planned to do next.  When these problems occur, it
  614. will suspend the current operation using the ALT-S function discussed
  615. earlier and exit the program.  This will prevent the unused keystrokes
  616. from spewing out after Prodigy has already gone away.
  617.  
  618. A common problem is a "no answer timeout" which causes Prodigy to
  619. switch to the "Try Again" screen.  When this happens, PDL may not yet
  620. have control, depending on the type of logon process that you are
  621. using.  In Prodigy Autologon or PDL autologon modes, the quotes will
  622. be suspended and Prodigy will be terminated.  This allows a 'clean'
  623. restart from the batch file.  In manual mode, the quote list will be
  624. suspended and the 'Try Again' screen will be entered to allow you to
  625. manually reconnect.     After this, you can enter an ALT-B or ALT-R to
  626. resume.  This method may result in lost or duplicated quotes.
  627.  
  628. If the line drops during a session, PDL cannot tell exactly how far you
  629. have gotten in the quotes file nor can it tell how much data has been
  630. lost.  It simply suspends the quote requests and terminates.
  631.  
  632. All of the above recovery actions are based on PDL being able to
  633. determine when the modem is online and when it is offline.  To do this,
  634. PDL interrogates the CARRIER DETECT signal to make sure that Prodigy is
  635. still connected to the service.  Your modem must be configured with "CD
  636. follows Carrier" (HayesII - ATS21=032).  PDL will check this at startup
  637. and warn you if "CD is always on".
  638.  
  639.  
  640. DELAY CONTROL
  641. -------------
  642.  
  643. Some machines experience problems of dropping characters from the
  644. keystroke file after switching screens within Prodigy.  This causes the
  645. keystroke sequences to get out of sync and occasionally jump to a screen
  646. that you don't want.  There are two delay values that can be controlled
  647. from the through the PDLCONF program:
  648.             P_DELAY   controls the delay after printing; if not
  649.                       specified the default is 400.
  650.                       If this is inadequate, try increasing the number
  651.                       in increments of 100.
  652.             D_DELAY   controls the delay after switching prodigy
  653.                       screens. This is a self adjusting time value based
  654.                       on machine speeds.  The default is 400.  If this
  655.                       is inadequate, the number should be increased in
  656.                       increments of 100 until quote requests run
  657.                       normally.
  658.  
  659.  
  660. DISCLAIMER
  661. ---------------
  662.  
  663. The author has made every effort to ensure that PDL will operate in
  664. most common environments.  However, the techniques that are used are
  665. heavily dependent on ISRs (Interrupt Service Routines) and may not
  666. operate correctly when used with TSR programs that intercept keyboard
  667. or printer interrupts.  If you experience problems such as "keyboard
  668. lockup" or runaway quote files (quote requests appearing on the DOS
  669. command line), try removing the other TSRs and rerunning.
  670.  
  671. The author assumes NO responsibility for any damages, direct or
  672. consequential, which may result from the use of PDL (Prodigy DownLoad).
  673. The user must accept and agree to this disclaimer of warranty prior to
  674. using PDL.
  675.  
  676. Some Common Problems
  677. --------------------
  678.  
  679. PDL starts up but as soon as the Prodigy Screen appears it immediately
  680. logs off.
  681.   This is usually due to an incorrect COMM PORT assignment. Rerun
  682.   PDLCONF and make sure that the port is assigned correctly. Be sure to
  683.   accept the data using the F10 key and save the files using the Update
  684.   Files function.
  685.  
  686. PDL starts up but the system "freezes up" when the Prodigy screen
  687. appears.
  688.   This is usually caused by insufficient memory for Prodigy. Make sure
  689.   that you have at least 500,000 bytes of DOS memory available.  If you
  690.   are using the scheduler (PDLSCHED) you should allow for 530,000.
  691.  
  692.   This problem can also be caused by memory resident programs (TSRs)
  693.   that intercept the keyboard (hot keys). For example, PCTOOLS running
  694.   in resident (-r) mode intercepts the keyboard and conflicts with PDL.
  695.  
  696. PDL will not logon to prodigy and a small letter 'e' appears in the
  697. logon field.
  698.   This can happen if you have specified LOGON TYPE = PRODIGY but you
  699.   have not set up your Prodigy Autologon with your ID and PASSWORD. Both
  700.   are required for Prodigy Autologon to work correctly.
  701.  
  702. The COMM PORT is correctly specified in PDLCONF but PDL still logs off
  703. of Prodigy immediately after the Prodigy screen appears.
  704.   This can be caused by a corrupted PDL.CNF file. Delete the file and
  705.   rerun PDLCONF.  This will rebuild the PDL.CNF and PDLRUN.BAT files.
  706.   Caution: PDL.CNF should not be edited with any program other than
  707.   PDLCONF.  Any imbeded characters can cause the configuration to work
  708.   incorrectly.
  709.  
  710.  
  711.  
  712. IBM is a registered trademark of International Business Machines
  713. Corporation.
  714. Prodigy is a registered service mark and trademark of Prodigy Services
  715. Company
  716.  
  717.